home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 May / Macworld (1998-05).dmg / Shareware World / Comms & Internet / ProTERM_1.2.5.Install / ProTERM Mac1.2.5 / Help / Receive ASCII Automatic < prev    next >
Text File  |  1998-02-13  |  8KB  |  166 lines

  1. ****** ProTERM HELP FILE ******
  2.        =================
  3.  
  4. ****** Automatic Receive ASCII Files ******
  5.  
  6. ****** Quick Index ******
  7.  
  8.  • ProTERM's Quick Index is available for this document.
  9.    When this file is opened from a ProTERM Help menu, a small table of
  10.    contents or "Index" window also opens to the right of this window: ===>>
  11.    Double-click any subject header in the Quick Index window to locate that
  12.    subject header here. Use the Quick Index window as a quick navigator tool.
  13.  
  14.  • Create Quick Indexes for your own ProTERM documents. For help on this
  15.    and other features, choose Help from the Apple menu (upper left corner).
  16. ** ——— **
  17.  
  18. ***** Description and Purpose *****
  19.  
  20. When one of the scripts below are used with an Autologon macro, the script can allow you to automatically (hands-off) capture an ASCII file of the entire session from the point of logon. The ASCII file opens, reads the entire sesssion, and closes at the end of the session. The scripts work when combined with the autologon in the dialer file for the service called.
  21.  
  22. **** Script Differences ****
  23.  
  24. The scripts are all the same with exception of what combination of the day, date and time is appended to the file when it is saved. The example names all include the name “Session <date> and/or <time>”. The default name “Session” can be changed to a name that suits your purpose.
  25.  
  26. By using a file that just saves the year and month, the same file will be appended to each time the session is saved for the period of the month. By using the combination of year, month and day, any calls during that day will be appended to the original file. If a new file is desired for every call, use one of the scripts that save the file with year, month, day and time.
  27.  
  28. **** Use with PTMM ****
  29.  
  30. Using the scripts with ProTERM Message Manager (PTMM)
  31. Although there are alternative and better ways to capture text when using PTMM (see Logfile.Keep in the PTMM Help menu), this script also works with PTMM dialers.
  32.  
  33. ***** Setup and Install *****
  34.  
  35.  • Decide which format you want to use from the selection below:
  36.  
  37. *** CONTENTS ***
  38.   ASCII RECEIVE EXAMPLE 1: [Session YYYY/MM/DD HHMM] (Session 1997/4/15 1053)
  39.   ASCII RECEIVE EXAMPLE 2: [Session MM/DD/YY]        (Session 4/15/97 1048)
  40.   ASCII RECEIVE EXAMPLE 3: [Session MM/DD/YY]        (Session 4/15/97)
  41.   ASCII RECEIVE EXAMPLE 4: [Session YYYY-MM-DD]      (Session 1997-4-15)
  42.   ASCII RECEIVE EXAMPLE 5: [Session YYMMDD HHMM]     (Session 970417 2228)
  43.   ASCII RECEIVE EXAMPLE 6: [Session YYMMDD]          (Session 970417)
  44.  
  45.  • Insert the cursor at the beginning of the script: “CMD_RCVASC...” Click
  46.    and drag to select all of the command script.
  47.  • Click on the Connect menu and choose the service you will be calling.
  48.  • Click on the Logon: radio button.
  49.    NOTE: If you do not have an autologon macro for the service, click Logon
  50.           Macro and change to Learn, call the service, and enter all the needed
  51.           information to call and logon to the service. Click Learn. (See the
  52.           ProTERM manual Index, Autolearn for details.)
  53.  • Insert the ASCII capture script into your autologon scrip somewhere before
  54.    or after where your password is printed (see example below).
  55.  
  56. **** Example with Autologon Macro ****
  57.  
  58. A simplified autologon macro that begins to save an ASCII file at logon, might look like this first example. The lines beginning with “PR” “WT” and END; are all part of the logon macro. The special script begins with “CMD”:
  59.  ---------------------------------------------------------------------------
  60. WT("-> "); 
  61. PR("accountname^M"); 
  62. WT("> "); 
  63. PR("password^M"); 
  64. CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %d-%d-%d",
  65.              TIME_TO(0,0), TIME_TO(0,1),  TIME_TO(0,2)), 1, 1, 1);
  66. END;
  67.  ---------------------------------------------------------------------------
  68.  
  69.  ===========================================================================
  70.  
  71. **** Script Command Descriptions ****
  72.  
  73. Several script examples are shown here. Each allows a different way to save the file with a name containing time and or date in various formats. Each will create and save a file with a name given by you, and be saved to a folder of your choice. The basic parts of the script break down as follows:
  74.  
  75.   CMD_RCVASC  Command Receive ASCII
  76.   STR_FORMAT  String Format
  77.        .APPL  Look in the folder where the ProTERM application is stored.
  78.   :Transfers  Look for a folder named Transfers
  79.     :Session  Name the file “Session <date> - <time>”
  80.  
  81. **** Scripts ****
  82.  
  83.  ===========================================================================
  84.  
  85.  ---------------------------------------------------------------------------
  86. *** 1: [Session YYYY/MM/DD HHMM] ***
  87.  
  88. This example autologon macro element saves the following: 
  89.   File named: Sessions <date> <time>
  90.  This format: Session YYYY/MM/DD HHMM (Session 1997/4/15 2153)
  91.  
  92.  CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %d/%d/%d %d%d",
  93.              TIME_TO(0,0), TIME_TO(0,1),  TIME_TO(0,2), TIME_TO(0,3),
  94.              TIME_TO(0,4)), 1, 1, 1);
  95.  
  96.  ---------------------------------------------------------------------------
  97. *** 2: [Session MM/DD/YY] ***
  98.  
  99. This example autologon macro element saves the following: 
  100.  File named: Sessions <date> <time>
  101. This format: Session MM/DD/YY (Session 4/15/97 1048)
  102.  
  103.  CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %D %d%d", 0
  104.              TIME_TO(0,3), TIME_TO(0,4)), 1, 1, 1);
  105.  
  106.  ---------------------------------------------------------------------------
  107. *** 3: [Session MM/DD/YY] ***
  108.  
  109. This example autologon macro element saves the following: 
  110.   File named: Sessions <date>
  111.  This format: Session MM/DD/YY (Session 4/15/97)
  112.  
  113.  CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %D", 0), 1, 1, 1);
  114.  
  115.  ---------------------------------------------------------------------------
  116. *** 4: [Session YYYY-MM-DD] ***
  117.  
  118. This example autologon macro element saves the following: 
  119.   File named: Sessions <date>
  120.  This format: Session YYYY-MM-DD (Session 1997-4-15)
  121.  
  122. CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %d-%d-%d",
  123.              TIME_TO(0,0), TIME_TO(0,1),  TIME_TO(0,2)), 1, 1, 1);
  124.  
  125.  ---------------------------------------------------------------------------
  126. *** 5: [Session YYMMDD HHMM] ***
  127.  
  128. This example autologon macro element saves the following: 
  129.   File named: Sessions <date> <time>
  130.  This format: Session YYMMDD HHMM (Session 970417 2228)
  131.  
  132.   CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %d%02d%02d %02d%02d",
  133.     TIME_TO(0,0) - (TIME_TO(0,0)/100*100), TIME_TO(0,1), TIME_TO(0,2),
  134.     TIME_TO(0,3), TIME_TO(0,4)), 1, 1, 1);
  135.  
  136.  ---------------------------------------------------------------------------
  137. *** 6: [Session YYMMDD] ***
  138.  
  139. This example autologon macro element saves the following: 
  140.   File named: Sessions <date>
  141.  This format: Session YYMMDD (Session 970417)
  142.  
  143.   CMD_RCVASC(0,STR_FORMAT(".APPL:Transfers:Session %02d%02d%02d",
  144.      TIME_TO(0,0)-(TIME_TO(0,0)/100*100), TIME_TO(0,1), TIME_TO(0,2));
  145.  
  146.  ---------------------------------------------------------------------------
  147.  Thanks to Chris Budewig and David Miller for help with these scripts.
  148.  
  149. ---
  150.  
  151. Let us know how ProTERM works for you.
  152.  
  153.  InTrec Software, Inc.   Sales ___________________        Tech ______
  154.  3035 E Topaz Circle     1888/PROTERM tollfree USA   Voc:602/992-1345
  155.  Phoenix, AZ 85028-4423  602/992-5515 outside USA    BBS:602/992-9789
  156.  Fax:602/992-0232        sales@intrec.com          proterm@intrec.com
  157.  URL <http://www.intrec.com>   FTP <ftp://ftp.intrec.com/pub/intrec/>
  158.    - Creative Macintosh and Apple II telecommunications solutions -
  159.  
  160. As always, if we can help... Ask! ;-)  Your questions help us add quality.
  161. Send a note to: proterm@intrec.com
  162.  
  163.  Last Updated: Feb 13, 1998
  164.  ©1994-98 InTrec Software, Inc.
  165.  Jerry Cline & Greg Schaefer
  166.